Bioimage.io description of an application.
No Additional PropertiesA human-friendly name of the resource description
Must be at least 1 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg', '.tif', '.tiff')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
cover.png
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 1 characters long
🦈
🦥
file and other attachments
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectcitations
No Additional Itemsfree text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a github repo URL in config since we already have the
git_repo field defined in the spec.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource
(packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectURL to download the resource from (deprecated)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A URL to the Git repository where the resource is being developed.
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified authors are maintainers and at least some of them should specify their github_user name
Affiliation
Resource description file (RDF) source; used to keep track of where an rdf.yaml was loaded from.
Do not set this field in a YAML file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
version number (n-th published version, not the semantic version)
The format version of this resource specification
(not the version of the resource description)
When creating a new resource always use the latest micro/patch version described here.
The format_version is important for any consumer software to understand how to parse the fields.
"0.2.4"
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
∈📦 URL or relative path to a markdown file with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
"application"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
URL or path to the source of the application
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Bioimage.io description of an application.
No Additional PropertiesA human-friendly name of the resource description.
May only contains letters, digits, underscore, minus, parentheses and spaces.
Must be at least 1 characters long
Must be at most 128 characters long
A string containing a brief description.
Must be at most 1024 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1 or 1:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 2 characters long
🦈
🦥
file attachments
No Additional Items∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
citations
Must contain a minimum of 1 items
free text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue
to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a GitHub repo URL in config since there is a git_repo field.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource.
(Packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files.)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectA URL to the Git repository where the resource is being developed.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration, e.g. on bioimage.io
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified, authors are maintainers and at least some of them has to specify their github_user name
Affiliation
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
The format version of this resource specification
"0.3.0"
∈📦 URL or relative path to a markdown file encoded in UTF-8 with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
"application"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
The description from which this one is derived
Must be at least 1 characters long
URL or path to the source of the application
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A bioimage.io dataset resource description file (dataset RDF) describes a dataset relevant to bioimage
processing.
A human-friendly name of the resource description
Must be at least 1 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg', '.tif', '.tiff')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
cover.png
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 1 characters long
🦈
🦥
file and other attachments
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectcitations
No Additional Itemsfree text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a github repo URL in config since we already have the
git_repo field defined in the spec.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource
(packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectURL to download the resource from (deprecated)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A URL to the Git repository where the resource is being developed.
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified authors are maintainers and at least some of them should specify their github_user name
Affiliation
Resource description file (RDF) source; used to keep track of where an rdf.yaml was loaded from.
Do not set this field in a YAML file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
version number (n-th published version, not the semantic version)
The format version of this resource specification
(not the version of the resource description)
When creating a new resource always use the latest micro/patch version described here.
The format_version is important for any consumer software to understand how to parse the fields.
"0.2.4"
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
∈📦 URL or relative path to a markdown file with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
"dataset"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
"URL to the source of the dataset.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A bioimage.io dataset resource description file (dataset RDF) describes a dataset relevant to bioimage
processing.
A human-friendly name of the resource description.
May only contains letters, digits, underscore, minus, parentheses and spaces.
Must be at least 1 characters long
Must be at most 128 characters long
A string containing a brief description.
Must be at most 1024 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1 or 1:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 2 characters long
🦈
🦥
file attachments
No Additional Items∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
citations
Must contain a minimum of 1 items
free text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue
to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a GitHub repo URL in config since there is a git_repo field.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource.
(Packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files.)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectA URL to the Git repository where the resource is being developed.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration, e.g. on bioimage.io
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified, authors are maintainers and at least some of them has to specify their github_user name
Affiliation
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
The format version of this resource specification
"0.3.0"
∈📦 URL or relative path to a markdown file encoded in UTF-8 with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
"dataset"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
The description from which this one is derived
Must be at least 1 characters long
"URL to the source of the dataset.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Specification of the fields used in a bioimage.io-compliant RDF that describes AI models with pretrained weights.
These fields are typically stored in a YAML file which we call a model resource description file (model RDF).
No Additional PropertiesA human-readable name of this model.
It should be no longer than 64 characters and only contain letter, number, underscore, minus or space characters.
Must be at least 1 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg', '.tif', '.tiff')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
cover.png
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 1 characters long
🦈
🦥
file and other attachments
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectcitations
No Additional Itemsfree text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a github repo URL in config since we already have the
git_repo field defined in the spec.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource
(packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectURL to download the resource from (deprecated)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A URL to the Git repository where the resource is being developed.
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified authors are maintainers and at least some of them should specify their github_user name
Affiliation
Resource description file (RDF) source; used to keep track of where an rdf.yaml was loaded from.
Do not set this field in a YAML file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
version number (n-th published version, not the semantic version)
Version of the bioimage.io model description specification used.
When creating a new model always use the latest micro/patch version described here.
The format_version is important for any consumer software to understand how to parse the fields.
"0.4.10"
Specialized resource type 'model'
"model"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
∈📦 URL or relative path to a markdown file with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
The documentation should include a '[#[#]]# Validation' (sub)section
with details on how to quantitatively validate the model on unseen data.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
Describes the input tensors expected by this model.
Must contain a minimum of 1 items
Tensor name. No duplicates are allowed.
Must be at least 1 characters long
Tuple (minimum, maximum) specifying the allowed range of the data in this tensor.
If not specified, the full data range that can be expressed in data_type is allowed.
Must contain a minimum of 2 items
Must contain a maximum of 2 items
For now an input tensor is expected to be given as float32.
The data flow in bioimage.io models is explained
in this diagram..
Specification of input tensor shape.
A sequence of valid shapes given by shape_k = min + k * step for k in {0, 1, ...}.
The minimum input shape
Must contain a minimum of 1 items
The minimum shape change
Must contain a minimum of 1 items
[1, 512, 512, 1]
min:
- 1
- 64
- 64
- 1
step:
- 0
- 32
- 32
- 0
Description of how this input should be preprocessed.
No Additional ItemsBinarizeDescr the tensor with a fixed BinarizeKwargs.threshold.
Values above the threshold will be set to one, values below the threshold to zero.
"binarize"
key word arguments for BinarizeDescr
The fixed threshold
Clip tensor values to a range.
Set tensor values below ClipKwargs.min to ClipKwargs.min
and above ClipKwargs.max to ClipKwargs.max.
"clip"
key word arguments for ClipDescr
minimum value for clipping
maximum value for clipping
Fixed linear scaling.
No Additional Properties"scale_linear"
key word arguments for ScaleLinearDescr
The subset of axes to scale jointly.
For example xy to scale the two image axes for 2d data jointly.
xy
multiplicative factor
additive term
The logistic sigmoid funciton, a.k.a. expit function.
No Additional Properties"sigmoid"
Subtract mean and divide by variance.
No Additional Properties"zero_mean_unit_variance"
key word arguments for ZeroMeanUnitVarianceDescr
The subset of axes to normalize jointly.
For example xy to normalize the two image axes for 2d data jointly.
xy
The mean value(s) to use for mode: fixed.
For example [1.1, 2.2, 3.3] in the case of a 3 channel image with axes: xy.
Must contain a minimum of 1 items
[1.1, 2.2, 3.3]
The standard deviation values to use for mode: fixed. Analogous to mean.
Must contain a minimum of 1 items
[0.1, 0.2, 0.3]
epsilon for numeric stability: out = (tensor - mean) / (std + eps).
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Scale with percentiles.
No Additional Properties"scale_range"
key word arguments for ScaleRangeDescr
For min_percentile=0.0 (the default) and max_percentile=100 (the default)
this processing step normalizes data to the [0, 1] intervall.
For other percentiles the normalized values will partially be outside the [0, 1]
intervall. Use ScaleRange followed by ClipDescr if you want to limit the
normalized values to a range.
The subset of axes to normalize jointly.
For example xy to normalize the two image axes for 2d data jointly.
xy
The lower percentile used to determine the value to align with zero.
The upper percentile used to determine the value to align with one.
Has to be bigger than min_percentile.
The range is 1 to 100 instead of 0 to 100 to avoid mistakenly
accepting percentiles specified in the range 0.0 to 1.0.
Epsilon for numeric stability.
out = (tensor - v_lower) / (v_upper - v_lower + eps);
with v_lower,v_upper values at the respective percentiles.
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Tensor name to compute the percentiles from. Default: The tensor itself.
For any tensor in inputs only input tensor references are allowed.
For a tensor in outputs only input tensor refereences are allowed if mode: per_dataset
Must be at least 1 characters long
A SPDX license identifier.
We do notsupport custom license beyond the SPDX license list, if you need that please
open a GitHub issue to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
Describes the output tensors.
Must contain a minimum of 1 items
Tensor name. No duplicates are allowed.
Must be at least 1 characters long
Tuple (minimum, maximum) specifying the allowed range of the data in this tensor.
If not specified, the full data range that can be expressed in data_type is allowed.
Must contain a minimum of 2 items
Must contain a maximum of 2 items
Data type.
The data flow in bioimage.io models is explained
in this diagram..
Output tensor shape.
Output tensor shape depending on an input tensor shape.
shape(output_tensor) = shape(input_tensor) * scale + 2 * offset
Name of the reference tensor.
Must be at least 1 characters long
outputpix/inputpix for each dimension.
'null' values indicate new dimensions, whose length is defined by 2*offset
Must contain a minimum of 1 items
Position of origin wrt to input.
Must contain a minimum of 1 items
The halo that should be cropped from the output tensor to avoid boundary effects.
The halo is to be cropped from both sides, i.e. shape_after_crop = shape - 2 * halo.
To document a halo that is already cropped by the model shape.offset has to be used instead.
Description of how this output should be postprocessed.
No Additional ItemsBinarizeDescr the tensor with a fixed BinarizeKwargs.threshold.
Values above the threshold will be set to one, values below the threshold to zero.
"binarize"
key word arguments for BinarizeDescr
The fixed threshold
Clip tensor values to a range.
Set tensor values below ClipKwargs.min to ClipKwargs.min
and above ClipKwargs.max to ClipKwargs.max.
"clip"
key word arguments for ClipDescr
minimum value for clipping
maximum value for clipping
Fixed linear scaling.
No Additional Properties"scale_linear"
key word arguments for ScaleLinearDescr
The subset of axes to scale jointly.
For example xy to scale the two image axes for 2d data jointly.
xy
multiplicative factor
additive term
The logistic sigmoid funciton, a.k.a. expit function.
No Additional Properties"sigmoid"
Subtract mean and divide by variance.
No Additional Properties"zero_mean_unit_variance"
key word arguments for ZeroMeanUnitVarianceDescr
The subset of axes to normalize jointly.
For example xy to normalize the two image axes for 2d data jointly.
xy
The mean value(s) to use for mode: fixed.
For example [1.1, 2.2, 3.3] in the case of a 3 channel image with axes: xy.
Must contain a minimum of 1 items
[1.1, 2.2, 3.3]
The standard deviation values to use for mode: fixed. Analogous to mean.
Must contain a minimum of 1 items
[0.1, 0.2, 0.3]
epsilon for numeric stability: out = (tensor - mean) / (std + eps).
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Scale with percentiles.
No Additional Properties"scale_range"
key word arguments for ScaleRangeDescr
For min_percentile=0.0 (the default) and max_percentile=100 (the default)
this processing step normalizes data to the [0, 1] intervall.
For other percentiles the normalized values will partially be outside the [0, 1]
intervall. Use ScaleRange followed by ClipDescr if you want to limit the
normalized values to a range.
The subset of axes to normalize jointly.
For example xy to normalize the two image axes for 2d data jointly.
xy
The lower percentile used to determine the value to align with zero.
The upper percentile used to determine the value to align with one.
Has to be bigger than min_percentile.
The range is 1 to 100 instead of 0 to 100 to avoid mistakenly
accepting percentiles specified in the range 0.0 to 1.0.
Epsilon for numeric stability.
out = (tensor - v_lower) / (v_upper - v_lower + eps);
with v_lower,v_upper values at the respective percentiles.
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Tensor name to compute the percentiles from. Default: The tensor itself.
For any tensor in inputs only input tensor references are allowed.
For a tensor in outputs only input tensor refereences are allowed if mode: per_dataset
Must be at least 1 characters long
Scale the tensor s.t. its mean and variance match a reference tensor.
No Additional Properties"scale_mean_variance"
key word arguments for ScaleMeanVarianceDescr
Name of tensor to match.
Must be at least 1 characters long
The subset of axes to scale jointly.
For example xy to normalize the two image axes for 2d data jointly.
Default: scale all non-batch axes jointly.
xy
Epsilon for numeric stability:
"`out = (tensor - mean) / (std + eps) * (refstd + eps) + refmean.
Value must be strictly greater than 0.0 and lesser or equal to 0.1
The persons that have packaged and uploaded this model.
Only required if those persons differ from the authors.
Affiliation
The model from which this model is derived, e.g. by fine-tuning the weights.
Reference to a bioimage.io model.
No Additional PropertiesA valid model id from the bioimage.io collection.
Must be at least 1 characters long
affable-shark
ambitious-sloth
version number (n-th published version, not the semantic version) of linked model
Custom run mode for this model: for more complex prediction procedures like test time
data augmentation that currently cannot be expressed in the specification.
No standard run modes are defined yet.
Run mode name
"deepimagej"
Run mode specific key word arguments
∈📦 URLs/relative paths to sample inputs to illustrate possible inputs for the model,
for example stored as PNG or TIFF images.
The sample files primarily serve to inform a human user about an example use case
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
∈📦 URLs/relative paths to sample outputs corresponding to the sample_inputs.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
∈📦 Test input tensors compatible with the inputs description for a single test case.
This means if your model has more than one input, you should provide one URL/relative path for each input.
Each test input should be a file with an ndarray in
numpy.lib file format.
The extension must be '.npy'.
Must contain a minimum of 1 items
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
∈📦 Analog to test_inputs.
Must contain a minimum of 1 items
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
The dataset used to train this model
Reference to a bioimage.io dataset.
No Additional PropertiesA valid dataset id from the bioimage.io collection.
Must be at least 1 characters long
version number (n-th published version, not the semantic version) of linked dataset
A bioimage.io dataset resource description file (dataset RDF) describes a dataset relevant to bioimage
processing.
A human-friendly name of the resource description
Must be at least 1 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg', '.tif', '.tiff')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
cover.png
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 1 characters long
🦈
🦥
file and other attachments
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectcitations
No Additional Itemsfree text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a github repo URL in config since we already have the
git_repo field defined in the spec.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource
(packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectURL to download the resource from (deprecated)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A URL to the Git repository where the resource is being developed.
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified authors are maintainers and at least some of them should specify their github_user name
Affiliation
Resource description file (RDF) source; used to keep track of where an rdf.yaml was loaded from.
Do not set this field in a YAML file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
version number (n-th published version, not the semantic version)
The format version of this resource specification
(not the version of the resource description)
When creating a new resource always use the latest micro/patch version described here.
The format_version is important for any consumer software to understand how to parse the fields.
"0.2.4"
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
∈📦 URL or relative path to a markdown file with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
"dataset"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
"URL to the source of the dataset.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
The weights for this model.
Weights can be given for different formats, but should otherwise be equivalent.
The available weight formats determine which consumers can use this model.
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Attachments that are specific to this weights entry.
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectDependency manager and dependency file, specified as <dependency manager>:<relative file path>.
^.+:.+$
conda:environment.yaml
maven:./pom.xml
pip:./requirements.txt
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
TensorFlow version used to create these weights
wraps a packaging.version.Version instance for validation in pydantic models
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Attachments that are specific to this weights entry.
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectDependency manager and dependency file, specified as <dependency manager>:<relative file path>.
^.+:.+$
conda:environment.yaml
maven:./pom.xml
pip:./requirements.txt
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
ONNX opset version
Value must be greater or equal to 7
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Attachments that are specific to this weights entry.
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectDependency manager and dependency file, specified as <dependency manager>:<relative file path>.
^.+:.+$
conda:environment.yaml
maven:./pom.xml
pip:./requirements.txt
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
callable returning a torch.nn.Module instance.
Local implementation: <relative path to file>:<identifier of implementation within the file>.
Implementation in a dependency: <dependency-package>.<[dependency-module]>.<identifier>.
^.+:.+$
^.+\..+$
my_function.py:MyNetworkClass
my_module.submodule.get_my_model
The SHA256 of the architecture source file, if the architecture is not defined in a module listed in dependencies
You can drag and drop your file to this
online tool to generate a SHA256 in your browser.
Or you can generate a SHA256 checksum with Python's hashlib,
here is a codesnippet.
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
key word arguments for the architecture callable
Version of the PyTorch library used.
If depencencies is specified it should include pytorch and the verison has to match.
(dependencies overrules pytorch_version)
wraps a packaging.version.Version instance for validation in pydantic models
∈📦 The multi-file weights.
All required files/folders should be a zip archive.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Attachments that are specific to this weights entry.
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectDependency manager and dependency file, specified as <dependency manager>:<relative file path>.
^.+:.+$
conda:environment.yaml
maven:./pom.xml
pip:./requirements.txt
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
Version of the TensorFlow library used.
wraps a packaging.version.Version instance for validation in pydantic models
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Attachments that are specific to this weights entry.
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectDependency manager and dependency file, specified as <dependency manager>:<relative file path>.
^.+:.+$
conda:environment.yaml
maven:./pom.xml
pip:./requirements.txt
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
Version of the TensorFlow library used.
wraps a packaging.version.Version instance for validation in pydantic models
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Attachments that are specific to this weights entry.
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectDependency manager and dependency file, specified as <dependency manager>:<relative file path>.
^.+:.+$
conda:environment.yaml
maven:./pom.xml
pip:./requirements.txt
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
Version of the PyTorch library used.
wraps a packaging.version.Version instance for validation in pydantic models
Specification of the fields used in a bioimage.io-compliant RDF to describe AI models with pretrained weights.
These fields are typically stored in a YAML file which we call a model resource description file (model RDF).
A human-readable name of this model.
It should be no longer than 64 characters
and may only contain letter, number, underscore, minus, parentheses and spaces.
We recommend to chose a name that refers to the model's task and image modality.
Must be at least 5 characters long
Must be at most 128 characters long
A string containing a brief description.
Must be at most 1024 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1 or 1:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 2 characters long
🦈
🦥
file attachments
No Additional Items∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
citations
Must contain a minimum of 1 items
free text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue
to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a GitHub repo URL in config since there is a git_repo field.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource.
(Packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files.)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectA URL to the Git repository where the resource is being developed.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration, e.g. on bioimage.io
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified, authors are maintainers and at least some of them has to specify their github_user name
Affiliation
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
Version of the bioimage.io model description specification used.
When creating a new model always use the latest micro/patch version described here.
The format_version is important for any consumer software to understand how to parse the fields.
"0.5.3"
Specialized resource type 'model'
"model"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
∈📦 URL or relative path to a markdown file with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
The documentation should include a '#[#] Validation' (sub)section
with details on how to quantitatively validate the model on unseen data.
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
Describes the input tensors expected by this model.
Must contain a minimum of 1 items
Input tensor id.
No duplicates are allowed across all inputs and outputs.
Must be at least 1 characters long
Must be at most 32 characters long
free text description
Must be at most 128 characters long
tensor axes
Must contain a minimum of 1 items
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"batch"
The batch size may be fixed to 1,
otherwise (the default) it may be chosen arbitrarily depending on available memory
1
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"channel"
Must contain a minimum of 1 items
Must be at least 1 characters long
The size/length of this axis can be specified as
- fixed integer
- parameterized series of valid sizes (ParameterizedSize)
- reference to another axis with an optional offset (SizeReference)
Value must be strictly greater than 0
Describes a range of valid tensor axis sizes as size = min + n*step.
Value must be strictly greater than 0
Value must be strictly greater than 0
A tensor axis size (extent in pixels/frames) defined in relation to a reference axis.
axis.size = reference.size * reference.scale / axis.scale + offset
note:
1. The axis and the referenced axis need to have the same unit (or no unit).
2. Batch axes may not be referenced.
3. Fractions are rounded down.
4. If the reference axis is concatenable the referencing axis is assumed to be
concatenable as well with the same block order.
example:
An unisotropic input image of wh=10049 pixels depicts a phsical space of 200196mm².
Let's assume that we want to express the image height h in relation to its width w
instead of only accepting input images of exactly 10049 pixels
(for example to express a range of valid image shapes by parametrizing w, see ParameterizedSize).
w = SpaceInputAxis(id=AxisId("w"), size=100, unit="millimeter", scale=2)
h = SpaceInputAxis(
... id=AxisId("h"),
... size=SizeReference(tensorid=TensorId("input"), axisid=AxisId("w"), offset=-1),
... unit="millimeter",
... scale=4,
... )
print(h.size.compute(h, w))
49
-> h = w * w.scale / h.scale + offset = 100 * 2mm / 4mm - 1 = 49
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
10
min: 32
step: 16
axis_id: a
offset: 5
tensor_id: t
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"index"
If a model has a concatenable input axis, it can be processed blockwise,
splitting a longer sample axis into blocks matching its input tensor description.
Output axes are concatenable if they have a SizeReference to a concatenable
input axis.
The size/length of this axis can be specified as
- fixed integer
- parameterized series of valid sizes (ParameterizedSize)
- reference to another axis with an optional offset (SizeReference)
Value must be strictly greater than 0
Describes a range of valid tensor axis sizes as size = min + n*step.
Value must be strictly greater than 0
Value must be strictly greater than 0
A tensor axis size (extent in pixels/frames) defined in relation to a reference axis.
axis.size = reference.size * reference.scale / axis.scale + offset
note:
1. The axis and the referenced axis need to have the same unit (or no unit).
2. Batch axes may not be referenced.
3. Fractions are rounded down.
4. If the reference axis is concatenable the referencing axis is assumed to be
concatenable as well with the same block order.
example:
An unisotropic input image of wh=10049 pixels depicts a phsical space of 200196mm².
Let's assume that we want to express the image height h in relation to its width w
instead of only accepting input images of exactly 10049 pixels
(for example to express a range of valid image shapes by parametrizing w, see ParameterizedSize).
w = SpaceInputAxis(id=AxisId("w"), size=100, unit="millimeter", scale=2)
h = SpaceInputAxis(
... id=AxisId("h"),
... size=SizeReference(tensorid=TensorId("input"), axisid=AxisId("w"), offset=-1),
... unit="millimeter",
... scale=4,
... )
print(h.size.compute(h, w))
49
-> h = w * w.scale / h.scale + offset = 100 * 2mm / 4mm - 1 = 49
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
10
min: 32
step: 16
axis_id: a
offset: 5
tensor_id: t
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"time"
Value must be strictly greater than 0.0
If a model has a concatenable input axis, it can be processed blockwise,
splitting a longer sample axis into blocks matching its input tensor description.
Output axes are concatenable if they have a SizeReference to a concatenable
input axis.
The size/length of this axis can be specified as
- fixed integer
- parameterized series of valid sizes (ParameterizedSize)
- reference to another axis with an optional offset (SizeReference)
Value must be strictly greater than 0
Describes a range of valid tensor axis sizes as size = min + n*step.
Value must be strictly greater than 0
Value must be strictly greater than 0
A tensor axis size (extent in pixels/frames) defined in relation to a reference axis.
axis.size = reference.size * reference.scale / axis.scale + offset
note:
1. The axis and the referenced axis need to have the same unit (or no unit).
2. Batch axes may not be referenced.
3. Fractions are rounded down.
4. If the reference axis is concatenable the referencing axis is assumed to be
concatenable as well with the same block order.
example:
An unisotropic input image of wh=10049 pixels depicts a phsical space of 200196mm².
Let's assume that we want to express the image height h in relation to its width w
instead of only accepting input images of exactly 10049 pixels
(for example to express a range of valid image shapes by parametrizing w, see ParameterizedSize).
w = SpaceInputAxis(id=AxisId("w"), size=100, unit="millimeter", scale=2)
h = SpaceInputAxis(
... id=AxisId("h"),
... size=SizeReference(tensorid=TensorId("input"), axisid=AxisId("w"), offset=-1),
... unit="millimeter",
... scale=4,
... )
print(h.size.compute(h, w))
49
-> h = w * w.scale / h.scale + offset = 100 * 2mm / 4mm - 1 = 49
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
10
min: 32
step: 16
axis_id: a
offset: 5
tensor_id: t
Must be at least 1 characters long
Must be at most 16 characters long
x
y
z
Must be at most 128 characters long
"space"
Value must be strictly greater than 0.0
If a model has a concatenable input axis, it can be processed blockwise,
splitting a longer sample axis into blocks matching its input tensor description.
Output axes are concatenable if they have a SizeReference to a concatenable
input axis.
An example tensor to use for testing.
Using the model with the test input tensors is expected to yield the test output tensors.
Each test tensor has be a an ndarray in the
numpy.lib file format.
The file extension must be '.npy'.
∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
A sample tensor to illustrate a possible input/output for the model,
The sample image primarily serves to inform a human user about an example use case
and is typically stored as .hdf5, .png or .tiff.
It has to be readable by the imageio library
(numpy's .npy format is not supported).
The image dimensionality has to match the number of axes specified in this tensor description.
∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Description of the tensor's data values, optionally per channel.
If specified per channel, the data type needs to match across channels.
A fixed set of nominal or an ascending sequence of ordinal values.
In this case data_type is required to be an unsigend integer type, e.g. 'uint8'.
String values are interpreted as labels for tensor values 0, ..., N.
Note: as YAML 1.2 does not natively support a "set" datatype,
nominal values should be given as a sequence (aka list/array) as well.
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
float32
uint8
uint16
int64
bool
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
float32
float64
uint8
uint16
Tuple (minimum, maximum) specifying the allowed range of the data in this tensor.
None corresponds to min/max of what can be expressed by data_type.
Must contain a minimum of 2 items
Must contain a maximum of 2 items
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
Scale for data on an interval (or ratio) scale.
Offset for data on a ratio scale.
Must contain a minimum of 1 items
A fixed set of nominal or an ascending sequence of ordinal values.
In this case data_type is required to be an unsigend integer type, e.g. 'uint8'.
String values are interpreted as labels for tensor values 0, ..., N.
Note: as YAML 1.2 does not natively support a "set" datatype,
nominal values should be given as a sequence (aka list/array) as well.
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
float32
uint8
uint16
int64
bool
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
float32
float64
uint8
uint16
Tuple (minimum, maximum) specifying the allowed range of the data in this tensor.
None corresponds to min/max of what can be expressed by data_type.
Must contain a minimum of 2 items
Must contain a maximum of 2 items
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
Scale for data on an interval (or ratio) scale.
Offset for data on a ratio scale.
indicates that this tensor may be None
Description of how this input should be preprocessed.
notes:
- If preprocessing does not start with an 'ensuredtype' entry, it is added
to ensure an input tensor's data type matches the input tensor's data description.
- If preprocessing does not end with an 'ensuredtype' or 'binarize' entry, an
'ensure_dtype' step is added to ensure preprocessing steps are not unintentionally
changing the data type.
Binarize the tensor with a fixed threshold.
Values above BinarizeKwargs.threshold/BinarizeAlongAxisKwargs.threshold
will be set to one, values below the threshold to zero.
"binarize"
key word arguments for BinarizeDescr
The fixed threshold
key word arguments for BinarizeDescr
The fixed threshold values along axis
Must contain a minimum of 1 items
The threshold axis
Must be at least 1 characters long
Must be at most 16 characters long
channel
Set tensor values below min to min and above max to max.
No Additional Properties"clip"
key word arguments for ClipDescr
minimum value for clipping
maximum value for clipping
cast the tensor data type to EnsureDtypeKwargs.dtype (if not matching)
"ensure_dtype"
key word arguments for EnsureDtypeDescr
Fixed linear scaling.
No Additional Properties"scale_linear"
key word arguments for ScaleLinearDescr
multiplicative factor
additive term
key word arguments for ScaleLinearDescr
The axis of of gains/offsets values.
Must be at least 1 characters long
Must be at most 16 characters long
channel
multiplicative factor
Must contain a minimum of 1 items
additive term
Must contain a minimum of 1 items
The logistic sigmoid funciton, a.k.a. expit function.
No Additional Properties"sigmoid"
Subtract a given mean and divide by the standard deviation.
Normalize with fixed, precomputed values for
FixedZeroMeanUnitVarianceKwargs.mean and FixedZeroMeanUnitVarianceKwargs.std
Use FixedZeroMeanUnitVarianceAlongAxisKwargs for independent scaling along given
axes.
"fixed_zero_mean_unit_variance"
key word arguments for FixedZeroMeanUnitVarianceDescr
The mean value to normalize with.
The standard deviation value to normalize with.
Value must be greater or equal to 1e-06
key word arguments for FixedZeroMeanUnitVarianceDescr
The mean value(s) to normalize with.
Must contain a minimum of 1 items
The standard deviation value(s) to normalize with.
Size must match mean values.
Must contain a minimum of 1 items
Value must be greater or equal to 1e-06
The axis of the mean/std values to normalize each entry along that dimension
separately.
Must be at least 1 characters long
Must be at most 16 characters long
channel
index
Subtract mean and divide by variance.
No Additional Properties"zero_mean_unit_variance"
key word arguments for ZeroMeanUnitVarianceDescr
The subset of axes to normalize jointly, i.e. axes to reduce to compute mean/std.
For example to normalize 'batch', 'x' and 'y' jointly in a tensor ('batch', 'channel', 'y', 'x')
resulting in a tensor of equal shape normalized per channel, specify axes=('batch', 'x', 'y').
To normalize each sample independently leave out the 'batch' axis.
Default: Scale all axes jointly.
Must be at least 1 characters long
Must be at most 16 characters long
['batch', 'x', 'y']
epsilon for numeric stability: out = (tensor - mean) / (std + eps).
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Scale with percentiles.
No Additional Properties"scale_range"
key word arguments for ScaleRangeDescr
For min_percentile=0.0 (the default) and max_percentile=100 (the default)
this processing step normalizes data to the [0, 1] intervall.
For other percentiles the normalized values will partially be outside the [0, 1]
intervall. Use ScaleRange followed by ClipDescr if you want to limit the
normalized values to a range.
The subset of axes to normalize jointly, i.e. axes to reduce to compute the min/max percentile value.
For example to normalize 'batch', 'x' and 'y' jointly in a tensor ('batch', 'channel', 'y', 'x')
resulting in a tensor of equal shape normalized per channel, specify axes=('batch', 'x', 'y').
To normalize samples indepdencently, leave out the "batch" axis.
Default: Scale all axes jointly.
Must be at least 1 characters long
Must be at most 16 characters long
['batch', 'x', 'y']
The lower percentile used to determine the value to align with zero.
Value must be greater or equal to 0.0 and strictly lesser than 100.0
The upper percentile used to determine the value to align with one.
Has to be bigger than min_percentile.
The range is 1 to 100 instead of 0 to 100 to avoid mistakenly
accepting percentiles specified in the range 0.0 to 1.0.
Value must be strictly greater than 1.0 and lesser or equal to 100.0
Epsilon for numeric stability.
out = (tensor - v_lower) / (v_upper - v_lower + eps);
with v_lower,v_upper values at the respective percentiles.
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Tensor ID to compute the percentiles from. Default: The tensor itself.
For any tensor in inputs only input tensor references are allowed.
Must be at least 1 characters long
Must be at most 32 characters long
Describes the output tensors.
Must contain a minimum of 1 items
Output tensor id.
No duplicates are allowed across all inputs and outputs.
Must be at least 1 characters long
Must be at most 32 characters long
free text description
Must be at most 128 characters long
tensor axes
Must contain a minimum of 1 items
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"batch"
The batch size may be fixed to 1,
otherwise (the default) it may be chosen arbitrarily depending on available memory
1
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"channel"
Must contain a minimum of 1 items
Must be at least 1 characters long
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"index"
The size/length of this axis can be specified as
- fixed integer
- reference to another axis with an optional offset (SizeReference)
- data dependent size using DataDependentSize (size is only known after model inference)
Value must be strictly greater than 0
A tensor axis size (extent in pixels/frames) defined in relation to a reference axis.
axis.size = reference.size * reference.scale / axis.scale + offset
note:
1. The axis and the referenced axis need to have the same unit (or no unit).
2. Batch axes may not be referenced.
3. Fractions are rounded down.
4. If the reference axis is concatenable the referencing axis is assumed to be
concatenable as well with the same block order.
example:
An unisotropic input image of wh=10049 pixels depicts a phsical space of 200196mm².
Let's assume that we want to express the image height h in relation to its width w
instead of only accepting input images of exactly 10049 pixels
(for example to express a range of valid image shapes by parametrizing w, see ParameterizedSize).
w = SpaceInputAxis(id=AxisId("w"), size=100, unit="millimeter", scale=2)
h = SpaceInputAxis(
... id=AxisId("h"),
... size=SizeReference(tensorid=TensorId("input"), axisid=AxisId("w"), offset=-1),
... unit="millimeter",
... scale=4,
... )
print(h.size.compute(h, w))
49
-> h = w * w.scale / h.scale + offset = 100 * 2mm / 4mm - 1 = 49
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
Value must be strictly greater than 0
Value must be strictly greater than 1
10
axis_id: a
offset: 5
tensor_id: t
The size/length of this axis can be specified as
- fixed integer
- reference to another axis with an optional offset (see SizeReference)
Value must be strictly greater than 0
A tensor axis size (extent in pixels/frames) defined in relation to a reference axis.
axis.size = reference.size * reference.scale / axis.scale + offset
note:
1. The axis and the referenced axis need to have the same unit (or no unit).
2. Batch axes may not be referenced.
3. Fractions are rounded down.
4. If the reference axis is concatenable the referencing axis is assumed to be
concatenable as well with the same block order.
example:
An unisotropic input image of wh=10049 pixels depicts a phsical space of 200196mm².
Let's assume that we want to express the image height h in relation to its width w
instead of only accepting input images of exactly 10049 pixels
(for example to express a range of valid image shapes by parametrizing w, see ParameterizedSize).
w = SpaceInputAxis(id=AxisId("w"), size=100, unit="millimeter", scale=2)
h = SpaceInputAxis(
... id=AxisId("h"),
... size=SizeReference(tensorid=TensorId("input"), axisid=AxisId("w"), offset=-1),
... unit="millimeter",
... scale=4,
... )
print(h.size.compute(h, w))
49
-> h = w * w.scale / h.scale + offset = 100 * 2mm / 4mm - 1 = 49
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
10
axis_id: a
offset: 5
tensor_id: t
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"time"
Value must be strictly greater than 0.0
The halo should be cropped from the output tensor to avoid boundary effects.
It is to be cropped from both sides, i.e. size_after_crop = size - 2 * halo.
To document a halo that is already cropped by the model use size.offset instead.
Value must be greater or equal to 1
reference to another axis with an optional offset (see SizeReference)
10
axis_id: a
offset: 5
tensor_id: t
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
Must be at least 1 characters long
Must be at most 16 characters long
Must be at most 128 characters long
"time"
Value must be strictly greater than 0.0
The size/length of this axis can be specified as
- fixed integer
- reference to another axis with an optional offset (see SizeReference)
Value must be strictly greater than 0
A tensor axis size (extent in pixels/frames) defined in relation to a reference axis.
axis.size = reference.size * reference.scale / axis.scale + offset
note:
1. The axis and the referenced axis need to have the same unit (or no unit).
2. Batch axes may not be referenced.
3. Fractions are rounded down.
4. If the reference axis is concatenable the referencing axis is assumed to be
concatenable as well with the same block order.
example:
An unisotropic input image of wh=10049 pixels depicts a phsical space of 200196mm².
Let's assume that we want to express the image height h in relation to its width w
instead of only accepting input images of exactly 10049 pixels
(for example to express a range of valid image shapes by parametrizing w, see ParameterizedSize).
w = SpaceInputAxis(id=AxisId("w"), size=100, unit="millimeter", scale=2)
h = SpaceInputAxis(
... id=AxisId("h"),
... size=SizeReference(tensorid=TensorId("input"), axisid=AxisId("w"), offset=-1),
... unit="millimeter",
... scale=4,
... )
print(h.size.compute(h, w))
49
-> h = w * w.scale / h.scale + offset = 100 * 2mm / 4mm - 1 = 49
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
10
axis_id: a
offset: 5
tensor_id: t
Must be at least 1 characters long
Must be at most 16 characters long
x
y
z
Must be at most 128 characters long
"space"
Value must be strictly greater than 0.0
The halo should be cropped from the output tensor to avoid boundary effects.
It is to be cropped from both sides, i.e. size_after_crop = size - 2 * halo.
To document a halo that is already cropped by the model use size.offset instead.
Value must be greater or equal to 1
reference to another axis with an optional offset (see SizeReference)
10
axis_id: a
offset: 5
tensor_id: t
tensor id of the reference axis
Must be at least 1 characters long
Must be at most 32 characters long
axis id of the reference axis
Must be at least 1 characters long
Must be at most 16 characters long
Must be at least 1 characters long
Must be at most 16 characters long
x
y
z
Must be at most 128 characters long
"space"
Value must be strictly greater than 0.0
An example tensor to use for testing.
Using the model with the test input tensors is expected to yield the test output tensors.
Each test tensor has be a an ndarray in the
numpy.lib file format.
The file extension must be '.npy'.
∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
A sample tensor to illustrate a possible input/output for the model,
The sample image primarily serves to inform a human user about an example use case
and is typically stored as .hdf5, .png or .tiff.
It has to be readable by the imageio library
(numpy's .npy format is not supported).
The image dimensionality has to match the number of axes specified in this tensor description.
∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Description of the tensor's data values, optionally per channel.
If specified per channel, the data type needs to match across channels.
A fixed set of nominal or an ascending sequence of ordinal values.
In this case data_type is required to be an unsigend integer type, e.g. 'uint8'.
String values are interpreted as labels for tensor values 0, ..., N.
Note: as YAML 1.2 does not natively support a "set" datatype,
nominal values should be given as a sequence (aka list/array) as well.
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
float32
uint8
uint16
int64
bool
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
float32
float64
uint8
uint16
Tuple (minimum, maximum) specifying the allowed range of the data in this tensor.
None corresponds to min/max of what can be expressed by data_type.
Must contain a minimum of 2 items
Must contain a maximum of 2 items
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
Scale for data on an interval (or ratio) scale.
Offset for data on a ratio scale.
Must contain a minimum of 1 items
A fixed set of nominal or an ascending sequence of ordinal values.
In this case data_type is required to be an unsigend integer type, e.g. 'uint8'.
String values are interpreted as labels for tensor values 0, ..., N.
Note: as YAML 1.2 does not natively support a "set" datatype,
nominal values should be given as a sequence (aka list/array) as well.
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
Must contain a minimum of 1 items
float32
uint8
uint16
int64
bool
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
float32
float64
uint8
uint16
Tuple (minimum, maximum) specifying the allowed range of the data in this tensor.
None corresponds to min/max of what can be expressed by data_type.
Must contain a minimum of 2 items
Must contain a maximum of 2 items
"arbitrary unit"
Si unit
Must match regular expression:^(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?((·(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^[+-]?[1-9]\d*)?)|(/(Q|R|Y|Z|E|P|T|G|M|k|h|da|d|c|m|µ|n|p|f|a|z|y|r|q)?(m|g|s|A|K|mol|cd|Hz|N|Pa|J|W|C|V|F|Ω|S|Wb|T|H|lm|lx|Bq|Gy|Sv|kat|l|L)(\^+?[1-9]\d*)?))*$
Must be at least 1 characters long
Scale for data on an interval (or ratio) scale.
Offset for data on a ratio scale.
Description of how this output should be postprocessed.
note: postprocessing always ends with an 'ensure_dtype' operation.
If not given this is added to cast to this tensor's data.type.
Binarize the tensor with a fixed threshold.
Values above BinarizeKwargs.threshold/BinarizeAlongAxisKwargs.threshold
will be set to one, values below the threshold to zero.
"binarize"
key word arguments for BinarizeDescr
The fixed threshold
key word arguments for BinarizeDescr
The fixed threshold values along axis
Must contain a minimum of 1 items
The threshold axis
Must be at least 1 characters long
Must be at most 16 characters long
channel
Set tensor values below min to min and above max to max.
No Additional Properties"clip"
key word arguments for ClipDescr
minimum value for clipping
maximum value for clipping
cast the tensor data type to EnsureDtypeKwargs.dtype (if not matching)
"ensure_dtype"
key word arguments for EnsureDtypeDescr
Fixed linear scaling.
No Additional Properties"scale_linear"
key word arguments for ScaleLinearDescr
multiplicative factor
additive term
key word arguments for ScaleLinearDescr
The axis of of gains/offsets values.
Must be at least 1 characters long
Must be at most 16 characters long
channel
multiplicative factor
Must contain a minimum of 1 items
additive term
Must contain a minimum of 1 items
The logistic sigmoid funciton, a.k.a. expit function.
No Additional Properties"sigmoid"
Subtract a given mean and divide by the standard deviation.
Normalize with fixed, precomputed values for
FixedZeroMeanUnitVarianceKwargs.mean and FixedZeroMeanUnitVarianceKwargs.std
Use FixedZeroMeanUnitVarianceAlongAxisKwargs for independent scaling along given
axes.
"fixed_zero_mean_unit_variance"
key word arguments for FixedZeroMeanUnitVarianceDescr
The mean value to normalize with.
The standard deviation value to normalize with.
Value must be greater or equal to 1e-06
key word arguments for FixedZeroMeanUnitVarianceDescr
The mean value(s) to normalize with.
Must contain a minimum of 1 items
The standard deviation value(s) to normalize with.
Size must match mean values.
Must contain a minimum of 1 items
Value must be greater or equal to 1e-06
The axis of the mean/std values to normalize each entry along that dimension
separately.
Must be at least 1 characters long
Must be at most 16 characters long
channel
index
Subtract mean and divide by variance.
No Additional Properties"zero_mean_unit_variance"
key word arguments for ZeroMeanUnitVarianceDescr
The subset of axes to normalize jointly, i.e. axes to reduce to compute mean/std.
For example to normalize 'batch', 'x' and 'y' jointly in a tensor ('batch', 'channel', 'y', 'x')
resulting in a tensor of equal shape normalized per channel, specify axes=('batch', 'x', 'y').
To normalize each sample independently leave out the 'batch' axis.
Default: Scale all axes jointly.
Must be at least 1 characters long
Must be at most 16 characters long
['batch', 'x', 'y']
epsilon for numeric stability: out = (tensor - mean) / (std + eps).
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Scale with percentiles.
No Additional Properties"scale_range"
key word arguments for ScaleRangeDescr
For min_percentile=0.0 (the default) and max_percentile=100 (the default)
this processing step normalizes data to the [0, 1] intervall.
For other percentiles the normalized values will partially be outside the [0, 1]
intervall. Use ScaleRange followed by ClipDescr if you want to limit the
normalized values to a range.
The subset of axes to normalize jointly, i.e. axes to reduce to compute the min/max percentile value.
For example to normalize 'batch', 'x' and 'y' jointly in a tensor ('batch', 'channel', 'y', 'x')
resulting in a tensor of equal shape normalized per channel, specify axes=('batch', 'x', 'y').
To normalize samples indepdencently, leave out the "batch" axis.
Default: Scale all axes jointly.
Must be at least 1 characters long
Must be at most 16 characters long
['batch', 'x', 'y']
The lower percentile used to determine the value to align with zero.
Value must be greater or equal to 0.0 and strictly lesser than 100.0
The upper percentile used to determine the value to align with one.
Has to be bigger than min_percentile.
The range is 1 to 100 instead of 0 to 100 to avoid mistakenly
accepting percentiles specified in the range 0.0 to 1.0.
Value must be strictly greater than 1.0 and lesser or equal to 100.0
Epsilon for numeric stability.
out = (tensor - v_lower) / (v_upper - v_lower + eps);
with v_lower,v_upper values at the respective percentiles.
Value must be strictly greater than 0.0 and lesser or equal to 0.1
Tensor ID to compute the percentiles from. Default: The tensor itself.
For any tensor in inputs only input tensor references are allowed.
Must be at least 1 characters long
Must be at most 32 characters long
Scale a tensor's data distribution to match another tensor's mean/std.
out = (tensor - mean) / (std + eps) * (ref_std + eps) + ref_mean.
"scale_mean_variance"
key word arguments for ScaleMeanVarianceKwargs
Name of tensor to match.
Must be at least 1 characters long
Must be at most 32 characters long
The subset of axes to normalize jointly, i.e. axes to reduce to compute mean/std.
For example to normalize 'batch', 'x' and 'y' jointly in a tensor ('batch', 'channel', 'y', 'x')
resulting in a tensor of equal shape normalized per channel, specify axes=('batch', 'x', 'y').
To normalize samples independently, leave out the 'batch' axis.
Default: Scale all axes jointly.
Must be at least 1 characters long
Must be at most 16 characters long
['batch', 'x', 'y']
Epsilon for numeric stability:
out = (tensor - mean) / (std + eps) * (ref_std + eps) + ref_mean.
Value must be strictly greater than 0.0 and lesser or equal to 0.1
The persons that have packaged and uploaded this model.
Only required if those persons differ from the authors.
Affiliation
The model from which this model is derived, e.g. by fine-tuning the weights.
Reference to a bioimage.io model.
No Additional PropertiesThe version of the linked resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
A valid model id from the bioimage.io collection.
Must be at least 1 characters long
Custom run mode for this model: for more complex prediction procedures like test time
data augmentation that currently cannot be expressed in the specification.
No standard run modes are defined yet.
Run mode name
"deepimagej"
Run mode specific key word arguments
The dataset used to train this model
Reference to a bioimage.io dataset.
No Additional PropertiesThe version of the linked resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
A valid dataset id from the bioimage.io collection.
Must be at least 1 characters long
A bioimage.io dataset resource description file (dataset RDF) describes a dataset relevant to bioimage
processing.
A human-friendly name of the resource description.
May only contains letters, digits, underscore, minus, parentheses and spaces.
Must be at least 1 characters long
Must be at most 128 characters long
A string containing a brief description.
Must be at most 1024 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1 or 1:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 2 characters long
🦈
🦥
file attachments
No Additional Items∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
citations
Must contain a minimum of 1 items
free text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue
to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a GitHub repo URL in config since there is a git_repo field.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource.
(Packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files.)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectA URL to the Git repository where the resource is being developed.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration, e.g. on bioimage.io
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified, authors are maintainers and at least some of them has to specify their github_user name
Affiliation
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
The format version of this resource specification
"0.3.0"
∈📦 URL or relative path to a markdown file encoded in UTF-8 with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
"dataset"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
The description from which this one is derived
Must be at least 1 characters long
"URL to the source of the dataset.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A bioimage.io dataset resource description file (dataset RDF) describes a dataset relevant to bioimage
processing.
A human-friendly name of the resource description
Must be at least 1 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg', '.tif', '.tiff')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
cover.png
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 1 characters long
🦈
🦥
file and other attachments
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectcitations
No Additional Itemsfree text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a github repo URL in config since we already have the
git_repo field defined in the spec.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource
(packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectURL to download the resource from (deprecated)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A URL to the Git repository where the resource is being developed.
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified authors are maintainers and at least some of them should specify their github_user name
Affiliation
Resource description file (RDF) source; used to keep track of where an rdf.yaml was loaded from.
Do not set this field in a YAML file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
version number (n-th published version, not the semantic version)
The format version of this resource specification
(not the version of the resource description)
When creating a new resource always use the latest micro/patch version described here.
The format_version is important for any consumer software to understand how to parse the fields.
"0.2.4"
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
∈📦 URL or relative path to a markdown file with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
"dataset"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
"URL to the source of the dataset.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
The weights for this model.
Weights can be given for different formats, but should otherwise be equivalent.
The available weight formats determine which consumers can use this model.
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
TensorFlow version used to create these weights.
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
ONNX opset version
Value must be greater or equal to 7
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
Identifier of the callable that returns a torch.nn.Module instance.
Must be at least 1 characters long
MyNetworkClass
get_my_model
key word arguments for the callable
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectIdentifier of the callable that returns a torch.nn.Module instance.
Must be at least 1 characters long
MyNetworkClass
get_my_model
key word arguments for the callable
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectWhere to import the callable from, i.e. from <import_from> import <callable>
Version of the PyTorch library used.
If architecture.depencencies is specified it has to include pytorch and any version pinning has to be compatible.
Custom depencies beyond pytorch.
The conda environment file should include pytorch and any version pinning has to be compatible with
pytorch_version.
∈📦 Conda environment file.
Allows to specify custom dependencies, see conda docs:
- Exporting an environment file across platforms
- Creating an environment file manually
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
environment.yaml
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
∈📦 The multi-file weights.
All required files/folders should be a zip archive.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
Version of the TensorFlow library used.
∈📦 The multi-file weights.
All required files/folders should be a zip archive.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
Version of the TensorFlow library used.
Custom dependencies beyond tensorflow.
Should include tensorflow and any version pinning has to be compatible with tensorflow_version.
∈📦 Conda environment file.
Allows to specify custom dependencies, see conda docs:
- Exporting an environment file across platforms
- Creating an environment file manually
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
environment.yaml
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
∈📦 The weights file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
The source weights these weights were converted from.
For example, if a model's weights were converted from the pytorch_state_dict format to torchscript,
The pytorch_state_dict weights entry has no parent and is the parent of the torchscript weights.
All weight entries except one (the initial set of weights resulting from training the model),
need to have this field.
pytorch_state_dict
Version of the PyTorch library used.
Bioimage.io description of a Jupyter Notebook.
No Additional PropertiesA human-friendly name of the resource description
Must be at least 1 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg', '.tif', '.tiff')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
cover.png
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 1 characters long
🦈
🦥
file and other attachments
∈📦 File attachments
No Additional ItemsA URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Additional Properties of any type are allowed.
Type: objectcitations
No Additional Itemsfree text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a github repo URL in config since we already have the
git_repo field defined in the spec.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource
(packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectURL to download the resource from (deprecated)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A URL to the Git repository where the resource is being developed.
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified authors are maintainers and at least some of them should specify their github_user name
Affiliation
Resource description file (RDF) source; used to keep track of where an rdf.yaml was loaded from.
Do not set this field in a YAML file.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
version number (n-th published version, not the semantic version)
The format version of this resource specification
(not the version of the resource description)
When creating a new resource always use the latest micro/patch version described here.
The format_version is important for any consumer software to understand how to parse the fields.
"0.2.4"
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
∈📦 URL or relative path to a markdown file with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
"notebook"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
The Jupyter notebook
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
Bioimage.io description of a Jupyter notebook.
No Additional PropertiesA human-friendly name of the resource description.
May only contains letters, digits, underscore, minus, parentheses and spaces.
Must be at least 1 characters long
Must be at most 128 characters long
A string containing a brief description.
Must be at most 1024 characters long
Cover images. Please use an image smaller than 500KB and an aspect ratio width to height of 2:1 or 1:1.
The supported image formats are: ('.gif', '.jpeg', '.jpg', '.png', '.svg')
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
UTF-8 emoji for display alongside the id.
Must be at least 1 characters long
Must be at most 2 characters long
🦈
🦥
file attachments
No Additional Items∈📦 file source
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
SHA256 checksum of the source file
A SHA-256 hash value
Must be at least 64 characters long
Must be at most 64 characters long
citations
Must contain a minimum of 1 items
free text description
A digital object identifier (DOI) is the prefered citation reference.
See https://www.doi.org/ for details. (alternatively specify url)
^10\.[0-9]{4}.+$
URL to cite (preferably specify a doi instead)
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A SPDX license identifier.
We do not support custom license beyond the SPDX license list, if you need that please
open a GitHub issue
to discuss your intentions with the community.
CC0-1.0
MIT
BSD-2-Clause
A field for custom configuration that can contain any keys not present in the RDF spec.
This means you should not store, for example, a GitHub repo URL in config since there is a git_repo field.
Keys in config may be very specific to a tool or consumer software. To avoid conflicting definitions,
it is recommended to wrap added configuration into a sub-field named with the specific domain or tool name,
for example:
config:
bioimageio: # here is the domain name
my_custom_key: 3837283
another_key:
nested: value
imagej: # config specific to ImageJ
macro_dir: path/to/macro/file
If possible, please use snake_case for keys in config.
You may want to list linked files additionally under attachments to include them when packaging a resource.
(Packaging a resource means downloading/copying important linked files and creating a ZIP archive that contains
an altered rdf.yaml file with local references to the downloaded files.)
bioimageio:
another_key:
nested: value
my_custom_key: 3837283
imagej:
macro_dir: path/to/macro/file
Each additional property must conform to the following schema
Type: objectEach additional property must conform to the following schema
Type: objectA URL to the Git repository where the resource is being developed.
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://github.com/bioimage-io/spec-bioimage-io/tree/main/example_descriptions/models/unet2d_nuclei_broad
An icon for illustration, e.g. on bioimage.io
Must be at least 1 characters long
Must be at most 2 characters long
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).
IDs of other bioimage.io resources
No Additional Items['ilastik/ilastik', 'deepimagej/deepimagej', 'zero/notebook_u-net_3d_zerocostdl4mic']
The person who uploaded the model (e.g. to bioimage.io)
name
Maintainers of this resource.
If not specified, authors are maintainers and at least some of them has to specify their github_user name
Affiliation
The version of the resource following SemVer 2.0.
wraps a packaging.version.Version instance for validation in pydantic models
The format version of this resource specification
"0.3.0"
∈📦 URL or relative path to a markdown file encoded in UTF-8 with additional documentation.
The recommended documentation file name is README.md. An .md suffix is mandatory.
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
https://raw.githubusercontent.com/bioimage-io/spec-bioimage-io/main/example_descriptions/models/unet2d_nuclei_broad/README.md
README.md
badges associated with this resource
No Additional ItemsA custom badge
No Additional Propertiesbadge label to display on hover
Open in Colab
badge icon
A path relative to the rdf.yaml file (also if the RDF source is a URL).
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/assets/colab-badge.svg
target URL
Must be at least 1 characters long
Must be at most 2083 characters long
https://colab.research.google.com/github/HenriquesLab/ZeroCostDL4Mic/blob/master/Colab_notebooks/U-net_2D_ZeroCostDL4Mic.ipynb
"notebook"
bioimage.io-wide unique resource identifier
assigned by bioimage.io; version unspecific.
Must be at least 1 characters long
The description from which this one is derived
Must be at least 1 characters long
The Jupyter notebook
A URL with the HTTP or HTTPS scheme.
Must be at least 1 characters long
Must be at most 2083 characters long
A path relative to the rdf.yaml file (also if the RDF source is a URL).